home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
EnigmA Amiga Run 1996 June
/
EnigmA AMIGA RUN 08 (1996)(G.R. Edizioni)(IT)[!][issue 1996-06][EARSAN CD VII].iso
/
earcd
/
comm2
/
mmtwtf12.lha
/
MM
/
Docs
/
MM_TwitFilter.Doc
< prev
Wrap
Text File
|
1996-04-29
|
8KB
|
277 lines
L L L L
LL LL LL LL
L L L L L L
L L L L
L L L L
LLLLL L L LLL LLLLL LLLLL LLL L LLLLL LLLLL LLLL
L L L L L L L L L L L L
L L L L L L LLLL L L L LLLL LLLL
L LL LL L L L L L L L L L
L L L LLL L L LLL LLLL L LLLLL L L
L L LL L LL
L L L L LL L L
L L L L L L L
L L L L L L
L LL L L LLLL
(C) 1996 Robert Hofmann
1. Introduction
===============
1.1 Legal stuff
---------------
MM_TwitFilter is, as the name already says, a twit-filter for Mail Manager by
Pino Aliberti.
The programs and files in this distribution are freely distributable, but are
also Copyright (c) Robert Hofmann. They may be freely distributed as long as
no more than a nominal fee is charged to cover time and copying costs.
No commercial usage is permitted without written permission from the author
Everything in this distribution must be kept together, in original unmodified
form.
MM_TwitFilter is mailware :-). This means if you use it, please write me a
short mail. You know, it is frustrating to write programs and there are no
responses from the users if they like it or not...
Accepting these few points is the only condition for using MM_TwitFilter...
=============================================================================
The author is not responsible for any problems caused by using this program!
=============================================================================
1.2 General stuff
-----------------
I am not the best in writing doc, but quiet good in coding I think :-) This
docs are a bit short I have to appolognize, but I hope you'll understand it
anyway... Especially my English and the typo's ;-)
If there is anybody out there who is able to & wants translate the docs to
his own language, please do so and send them to me! I'll add them to the next
release. Also translators always will get the newest betas! ;-)
Unfortunatly I don't have the will & time to translate my docs even to German
- my time is better used for coding :-)
1.3 Author
----------
If you have suggestions or remarks about this program, or if you find any
bugs, please let me know.
Contacting the author:
Internet .. : robert@next.amistep.osn.de (soon!)
FidoNet ... : 2:2490/1015.0 (may change soon!)
AmigaNet .. : 39:171/101.0
Snail-mail : Robert Hofmann
Volkmannstr. 35
D-90443 Nürnberg
Tel. +49-(0)-911-9941680 (18-20h German time only!!!)
Germany
Bank-Account: Account-holder: Robert Hofmann
Account-number: 67920
Bank-ID ..... : 76090000
S.W.I.F.T.code: GENO DE MV 760
Bank-name ... : Volksbank Nuernberg e.G.
2. Features
===========
MM_TwitFilter...
... is configurable per area & global
... is able to check single, multiple or all areas
... has a full AmigaDos-wildcard-support
... is able to search over all msg-fields (single or combined!)
... can use the DEL-flag or physically deletes the msg
... has an advanced cfg-read-meachanism
... does only process #ECHOAREAs, excluding own msgs
3. Installation
===============
1. Copy the files to the related MM:-directories.
2. Adjust the cfg to your own needs.
3. Add it as last entry to your import-batch or whatever else you use.
4. Add the following line to your MM.cfg:
#BROWSEMENU "Filter this area" "rx MM:Rexx/MM_TwitFilter %a" ""
IMPORTANT: MM_TwitFilter.rexx *MUST* be placed in "MM:Rexx/"!!! This is
necessary because MM_TwitFilter appends its cfg to the script
itself for a *VERY* fast cfg-reading.
*** NEVER TOUCH ITS FILENOTE!!! ***
As you may have seen, there's a second script called "MM_TwitFilter.rexx.cmp"
included. This is a exacltly the same script as "MM_TwitFilter.rexx" itself,
except that it was compressed with "CompressRexx v2.1".
On slow machines, it might be useful to replace the uncompressed script with
the compressed one because it is slightly faster... But please test it first
with the uncompressed version, because if an error occurs, finding the error
due to error-reports of the compressed script is nearly impossible!
If you really want to use the compressed script, you have to REPLACE the un-
compressed script with the compressed one! The used script MUST exactly named
"MM:Rexx/MM_TwitFilter.rexx", otherwise it will not work!
4. Usage
========
[RX] MM_TwitFilter[.rexx] AREA,SETDEL/S
AREA Areatag. If not present, all configured areas will be filtered.
SETDEL Instead of directly deleting the msg, it will be flagged as 'DEL'.
This is much slower than simply deleting the msg!
5. Configuration
================
5.1 #AREA <areatag>
-------------------
The areatag of the area.
Kill <from-pattern> <to-pattern> <subj-pattern>
KillFrom <pattern>
KillTo <pattern>
KillSubj <pattern>
The pattern must be a valid AmigaDos-wildcard (see e.g. the example-cfg).
Multiple statments are possible, but slower that if you use advanced wild-
cards, e.g.
KillFrom "Joe User"
KillFrom "Henry Twit"
is the same like
KillFrom "*(Joe User|Henry Twit)*"
but the second example is much faster!
5.2 #ALL
--------
This is the global entry. You must not set an areatag here, of course :-)
The usage of Kill*-keywords is the same as in 5.1.
6. Theory of operation
======================
MM_TwitFilter normally should be started directly after your import, so that
all twits can be filtered out immediately.
It will only be searched for SENT msgs not written by you yourself.
For every Kill-statement it will be started one search. So the more statements
you use the slower it will be.
If you want to try it out, just use SETDEL/S, so the msgs will not be deleted
immediately, but only flagged as DEL, so you can clear this flag if you made a
mistake.
IMPORTANT NOTE: It would be an excessivly annoying behaviour if you modify the
script and use it on TwoPassImport-areas to filter people you
don't like!!!
PS: I've not fully tested it, so there might be some bugs left.
Please report them to me!
7. Acknowledgements
===================
Pino Aliberti For his EXCELLENT Mail Manager! For implementing nearly all
I wanted (this was much work I think and delayed the release
of MM for some month ;-)) For our hard but fair fights in
MMBETA and at least for the nice note about me in the docs
8^))))
_ o Robert Hofmann 2:2490/1015@FidoNet 37:108/220@TrekNet
|<)_/# 39:171/101@AmigaNet 107:1805/230@TrekNet
TT <T robert@next.amistep.osn.de 56:63/201@XNet 213:314/9127@XCessNet